package com.example.common;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.slf4j.MDC;

import java.util.HashMap;
import java.util.Map;

/**
 * API统一响应结构
 *
 * @param <T> 响应数据类型
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class ResultResponse<T> {
    /**
     * 业务状态码（非HTTP状态码）
     */
    private String code;
    
    /**
     * 用户友好提示（支持国际化）
     */
    private String message;
    
    /**
     * 业务数据载体
     */
    private T data;
    
    /**
     * 请求追踪ID（结合日志系统）
     */
    private String traceId;
    
    /**
     * 响应生成时间戳
     */
    private Long timestamp;
    
    /**
     * 分页信息/附加数据
     */
    private Map<String, Object> metadata;
    
    /**
     * 成功响应工厂方法
     *
     * @param data 响应数据
     * @param <T> 数据类型
     * @return API响应对象
     */
    public static <T> ResultResponse<T> success(T data) {
        return new ResultResponse<>("200", "操作成功", data, MDC.get("traceId"),
                System.currentTimeMillis(), null);
    }
    
    /**
     * 失败响应工厂方法
     *
     * @param errorCode 错误码对象
     * @param <T> 数据类型
     * @return API响应对象
     */
    public static <T> ResultResponse<T> failure(ErrorCode errorCode) {
        return new ResultResponse<>(errorCode.getCode(), errorCode.getDesc(), null,
                MDC.get("traceId"), System.currentTimeMillis(), null);
    }
    
    /**
     * 链式扩展方法
     *
     * @param key 元数据键
     * @param value 元数据值
     * @return 当前API响应对象
     */
    public ResultResponse<T> addMetadata(String key, Object value) {
        if (this.metadata == null) {
            this.metadata = new HashMap<>();
        }
        this.metadata.put(key, value);
        return this;
    }
} 